文字種の制限

CalendarGcCharMaskCellTypeでは、入力可能な文字種をFormatプロパティで制限することができます。Formatプロパティに設定できるキーワードは、次の表のとおりです。また、ここで指定された以外の文字種が入力されると、GcCharMask.InvalidInputイベントが発生します。

注意 CalendarGcCharMaskCellTypeではサロゲート ペア文字は入力できません。 また、半角文字と全角文字は、その文字のShift-JISコードを使って識別されます。

Imports InputManCell = GrapeCity.Win.CalendarGrid.InputMan

Dim today As DateTime = DateTime.Today

Dim GcCharMaskCellType As New InputManCell.CalendarGcCharMaskCellType()
GcCharMaskCellType.Format = "AB"

GcCalendarGrid1.Content(today).Rows(1).Cells(0).CellType = GcCharMaskCellType
GcCalendarGrid1.ScrollIntoView(today)

using InputManCell = GrapeCity.Win.CalendarGrid.InputMan;

var today = DateTime.Today;

var gcCharMaskCellType = new InputManCell.CalendarGcCharMaskCellType();
gcCharMaskCellType.Format = "AB";

gcCalendarGrid1.Content[today].Rows[1].Cells[0].CellType = gcCharMaskCellType;
gcCalendarGrid1.ScrollIntoView(today);

上記のコードのFormatプロパティを変更することで入力可能な文字種を設定できます。
次の例では、半角大文字のアルファベットと数字（0～9）が入力可能になります。キーワード"X"で指定した16進数は、別のキーワードの"A"と"9"に含まれているので、無視されます。

GcCharMaskCellType.Format = "AX9"

gcCharMaskCellType.Format = "AX9";

下のコードでは、すべての半角文字の入力が許可されます。キーワード"AaK9"で指定した文字種は"H"に包含されているので、この部分は無視されます。

GcCharMaskCellType.Format = "AaK9H"

gcCharMaskCellType.Format = "AaK9H";

次に示す２つの例は、どちらもスペースを含むすべての文字種を許可するものです。デフォルトでは、最初の例のように設定されていますので、２つ目の例のようにキーワード"ＺH"を指定しなくても同じ動作となります。

GcCharMaskCellType.Format = ""
GcCharMaskCellType.AllowSpace = InputMan.CalendarGridAllowSpace.Both

GcCharMaskCellType.Format = "ＺH"
GcCharMaskCellType.AllowSpace = InputMan.CalendarGridAllowSpace.Both

gcCharMaskCellType.Format = "";
gcCharMaskCellType.AllowSpace = InputManCell.CalendarGridAllowSpace.Both;

gcCharMaskCellType.Format = "ＺH";
gcCharMaskCellType.AllowSpace = InputManCell.CalendarGridAllowSpace.Both;

以下の２つのコードは、すべての文字種の入力を拒否します。スペースの入力も許可されません。この例が示すように、キーワード"^"は、その後に記述されたキーワードの補集合を表します。

GcCharMaskCellType.Format = "^"
GcCharMaskCellType.AllowSpace = InputMan.CalendarGridAllowSpace.None

GcCharMaskCellType.Format = "^ＺH"
GcCharMaskCellType.AllowSpace = InputMan.CalendarGridAllowSpace.None

gcCharMaskCellType.Format = "^";
gcCharMaskCellType.AllowSpace = InputManCell.CalendarGridAllowSpace.None;

gcCharMaskCellType.Format = "^ＺH";
gcCharMaskCellType.AllowSpace = InputManCell.CalendarGridAllowSpace.None;

また、入力可能な文字種から特定の文字種を除外することもできます。次のコードはすべての全角文字から絵記号だけを除外します。

GcCharMaskCellType.Format = "Ｚ^Ｅ"

gcCharMaskCellType.Format = "Ｚ^Ｅ";

特定の文字を書式に設定することも可能です。記号から「^、@、\、$」の4文字を除外するには以下のように記述します。

GcCharMaskCellType.Format = "@^\^\@\\$"

gcCharMaskCellType.Format = "@^\\^\\@\\\\$";

文字列の自動変換

CalendarGcCharMaskCellType.AutoConvertプロパティを使用します。

AutoConvertプロパティをTrueに設定すると、Formatプロパティの設定内容に基づいて、変換可能な文字はすべて自動的に変換されます。たとえば、Formatプロパティで"A"キーワードが設定されていると、小文字を入力しても自動的に大文字に変換されます。また、全角文字だけが許可されている場合は、入力された半角文字は全角文字に変換されます。

セル内部で行われる自動変換の手順を以下に示します。

1. 小文字から大文字、または大文字から小文字への変換を行います。
2. 手順 １ の変換が行われない場合、全角から半角、または半角から全角への変換を行います。
3. 手順 ２ の変換が行われない場合、全角大文字から半角小文字、全角小文字から半角大文字、半角大文字から全角小文字、半角小文字から全角大文字のいずれかの変換を行います。

半角カタカナ、全角カタカナ、およびひらがなは、次のように変換されます。

• 半角カタカナは全角カタカナに変換。変換できない場合はひらがなに変換。
• 全角カタカナは半角カタカナに変換。変換できない場合はひらがなに変換。
• ひらがなは全角カタカナに変換。変換できない場合は半角カタカナに変換。
  

スペース入力の制御

CalendarGcCharMaskCellType.AllowSpaceプロパティを使用します。

AllowSpaceプロパティは、Formatの設定に依存せずに入力可能なスペースの種類を設定します。AllowSpaceプロパティがWideに設定されている場合、Formatプロパティにキーワード"H"のみが設定されていても、セルには全角のスペースのみ入力可能です。また、同様にAllowSpaceプロパティがNarrowに設定されている場合、キーワード"Ｚ"のみが設定されていても、半角のスペースだけが入力可能になります。

注意  既存のテキストにスペースが含まれているときに、AllowSpaceをNoneに設定すると、それらのスペースがすべて削除されるので注意が必要です。

改行コードの取り扱い

CalendarGcCharMaskCellType.AcceptsCrLfプロパティを使用します。

AcceptsCrLfプロパティを使用してクリップボードへ改行を含む文字列をコピー、または貼り付けた場合の改行コードの扱いを設定できます。AcceptsCrLfプロパティは、以下の3つの動作から選択します。

© 2014 GrapeCity inc. All rights reserved.